CSSPrimitiveValue: setStringValue() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die setStringValue() Methode des CSSPrimitiveValue-Interfaces wird verwendet, um einen String-Wert festzulegen. Wenn die mit diesem Wert verknüpfte Eigenschaft die angegebene Einheit oder den String-Wert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException wird ausgelöst.

Hinweis: Diese Methode war Teil eines Versuchs, ein typisiertes CSS-Objektmodell zu erstellen. Dieser Versuch wurde aufgegeben, und die meisten Browser implementieren es nicht.

Um Ihr Ziel zu erreichen, können Sie Folgendes verwenden:

das untypisierte CSS-Objektmodell, das breit unterstützt wird, oder
das moderne CSS Typed Object Model API, das weniger unterstützt wird und als experimentell gilt.

Syntax

setStringValue(stringType, stringValue)

Parameter

stringType

Ein unsigned short, der den Typ des Wertes darstellt. Mögliche Werte sind:

Konstante	Beschreibung
`CSS_ATTR`	Der Wert ist eine `attr()`-Funktion.
`CSS_IDENT`	Der Wert ist ein Bezeichner.
`CSS_STRING`	Der Wert ist ein `<string>`.
`CSS_URI`	Der Wert ist ein `<url>`.

stringValue

Ein String, der den neuen String-Wert repräsentiert.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidAccessError DOMException: Wird ausgelöst, wenn der CSS-Wert keinen String-Wert enthält oder wenn der String-Wert nicht in die angegebene Einheit umgewandelt werden kann.
NoModificationAllowedError DOMException: Wird ausgelöst, wenn die Eigenschaft schreibgeschützt ist.

Spezifikationen

Dieses Feature wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, aber seitdem aus jeglichen Standardisierungsbemühungen entfernt.

Es wurde durch eine moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich jetzt auf dem Standardpfad befindet.